From: Florian Müllner Date: Wed, 17 Jan 2024 02:54:29 +0000 (+0100) Subject: docs: Add section on feature requests X-Git-Tag: archive/raspbian/50.5-1+rpi1~1^2~281^2~2^2~88 X-Git-Url: https://dgit.raspbian.org/%22http://www.example.com/cgi/%22/%22http:/www.example.com/cgi/%22?a=commitdiff_plain;h=afc2a7d652383a43555dc4717276f0171dfca993;p=gnome-shell.git docs: Add section on feature requests Small and well-defined feature requests can be very useful, but unfortunately too many are neither small nor well-defined. Try to improve on that by adding another README section that explains that changes need design approval, and points to appropriate places to have broader design discussions, hopefully without being too off-putting. While this is unlikely to stop all "bad" feature requests, it at least gives us something to point to when closing requests. Part-of: --- diff --git a/README.md b/README.md index 592a58f31..4f3841b18 100644 --- a/README.md +++ b/README.md @@ -51,6 +51,28 @@ you can use: [matrix-room]: https://matrix.to/#/#gnome-shell:gnome.org [discourse]: https://discourse.gnome.org +## Feature requests + +gnome-shell is a core compoment of the GNOME desktop experience. +As such, any changes in behavior or appearance only happen in +accordance with the [GNOME design team][design-team]. + +For major changes, it is best to start a discussion on [discourse] +and reach out on the [#gnome-design matrix room][design-room], +and only involve the issue tracker once agreement has been reached. + +In particular mockups must be approved by the design team to be +considered for implementation. + +For enhancements that are limited in scope and well-defined, +it is acceptable to directly open a feature request. + +When in doubt, it is better to ask before opening an issue. + +[design-team]: https://gitlab.gnome.org/Teams/Design +[discourse]: https://discourse.gnome.org +[design-room]: https://matrix.to/#/#gnome-design:gnome.org + ## Contributing To contribute, open merge requests at https://gitlab.gnome.org/GNOME/gnome-shell.